package com.itlong.cloud.operate.service;

import com.itlong.cloud.POJO.DTO.operate.OperatePropertyAccountGetPageDTO;
import com.itlong.cloud.POJO.DTO.operate.OperatePropertyAccountSaveDTO;
import com.itlong.cloud.POJO.DTO.operate.OperatePropertyAccountUpdateDTO;
import com.itlong.cloud.POJO.DTO.operate.OperatePropertyDeveloperGetPageDTO;
import com.itlong.cloud.POJO.VO.app.robot.AppProjectRobotInfoVO;
import com.itlong.cloud.POJO.VO.operate.OperatePropertyAccountDetailVO;
import com.itlong.cloud.POJO.VO.operate.OperatePropertyAccountVO;
import com.itlong.cloud.POJO.VO.operate.OperatePropertyDeveloperVO;
import com.itlong.cloud.POJO.VO.operate.OperatePropertyRoleVO;
import com.itlong.cloud.utils.page.Page;
import org.apache.ibatis.annotations.Param;
import org.springframework.web.bind.annotation.PostMapping;

import java.util.List;

/**
 * <desc>
 *      物业账号信息处理接口
 * </desc>
 *
 * @createDate 2017-10-25.
 */
public interface IOperatePropertyAccountService {

    /**
     * <desc>
     *      获取公共管理员角色列表
     * <desc/>
     *
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-27
     */
    List<OperatePropertyRoleVO> getPropertyRoles() throws Exception;

    /**
     * <desc>
     *      判断账号名是否已存在
     * <desc/>
     *
     * @param userName 账号名
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-25
     */
    Integer checkPropertyAccount(String userName) throws Exception;

    /**
     * <desc>
     *      判断某项目某角色用户是否已存在（一个项目的一个角色，只能有一个用户）
     * <desc/>
     *
     * @param projectId 项目编号
     * @param roleId 角色id
     * @param propertyUserId 物业用户id
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-31
     */
    Integer checkProjectRoleExist(String projectId, String roleId, String propertyUserId) throws Exception;


    /**
     * <desc>
     *      添加新的物业账号
     * <desc/>
     *
     * @param saveDTO 新增物业账号
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-25
     */
    Integer savePropertyAccount(OperatePropertyAccountSaveDTO saveDTO) throws Exception;


    /**
     * <desc>
     * 添加新的物业账号(返回账号)
     * <desc/>
     *
     * @param saveDTO 新增物业账号信息
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-27
     */
    String savePropertyAccountSaas(OperatePropertyAccountSaveDTO saveDTO) throws Exception;

    /**
     * <desc>
     *      更新单个物业账号信息
     * <desc/>
     *
     * @param updateDTO 物业账号更新信息
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-26
     */
    Integer updatePropertyAccount(OperatePropertyAccountUpdateDTO updateDTO) throws Exception;

    /**
     * <desc>
     *      批量删除物业账号
     * <desc/>
     *
     * @param userIds 物业账号id列表，多个以英文逗号分隔
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-27
     */
    Integer removePropertyAccounts(String userIds) throws Exception;

    /**
     * <desc>
     *      分页查询物业账号
     * <desc/>
     *
     * @param pageDTO 查询条件DTO
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-25
     */
    Page<OperatePropertyAccountVO> getPage(OperatePropertyAccountGetPageDTO pageDTO) throws Exception;

    /**
     * <desc>
     *      获取单个账户详情
     * <desc/>
     *
     * @param userId 账户id
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-26
     */
    OperatePropertyAccountDetailVO getDetail(String userId) throws Exception;

    /**
     * <desc>
     *      批量重置物业账号密码
     * <desc/>
     *
     * @param userIds 物业账号id列表，多个以英文逗号分隔
     * @return
     * @author Chunjian.G
     * @createDate 2017-10-27
     */
    Integer resetPassword(String userIds) throws Exception;

    /**
     * <desc>
     *      分页获取物业开发者账号列表
     * <desc/>
     *
     * @param pageDTO 查询条件
     * @return
     * @author Qiang.S
     * @createDate 2018-06-29
     */
    Page<OperatePropertyDeveloperVO> getDeveloperPage(OperatePropertyDeveloperGetPageDTO pageDTO) throws Exception;

    /**
     * <desc>
     *      删除开发者账号
     * <desc/>
     *
     * @param userId 物业账号id
     * @param projectId 项目编号
     * @return
     * @author Qiang.S
     * @createDate 2018-09-07
     */
    Integer removePropertyDeveloper(String userId,String projectId) throws Exception;

    /**
     * <desc>
     *      获取开发者下的项目及机器人信息
     * </desc>
     *
     * @param userId 开发者用户id
     * @return 项目及机器人信息
     * @Author Zhu.yj
     * @createDate  2020/8/25
     */
    List<AppProjectRobotInfoVO> getProjectRobotInfoByDeveloper(String userId, String loginType) throws Exception;

    /**
     * <desc>
     *      获取工程人员项目
     * </desc>
     *
     * @param userId 用户id
     * @return
     * @Author Zhu.yj
     * @createDate  2020/8/25
     */
    List<String> getEngineerProjectIds(String userId) throws Exception;


    /**
     * <desc>
     *      分页获取管理员列表
     * </desc>
     *
     * @param accountGetPageDTO 分页查询参数DTO
     * @return
     * @Author Zhu.yj
     * @createDate  2020/10/22
     */
    Page<OperatePropertyAccountVO> getAdminPage(OperatePropertyAccountGetPageDTO accountGetPageDTO) throws Exception;


    /**
     * <desc>
     *      处理集团物业管理员旧数据菜单，收回不该有的权限
     * </desc>
     *
     * @param
     * @return
     * @Author Zhu.yj
     * @createDate  2021/5/21
     */
    Integer handlerGroupAdminFunction() throws Exception;

}
